home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3dm / dmedia / dmGSMEncode.z / dmGSMEncode
Encoding:
Text File  |  2002-10-03  |  5.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ddddmmmmGGGGSSSSMMMMEEEEnnnnccccooooddddeeee((((3333ddddmmmm))))                                              ddddmmmmGGGGSSSSMMMMEEEEnnnnccccooooddddeeee((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      dmGSMEncode - implements the European GSM 06.10 provisional standard for
  10.      full-rate speech transcoding, prI-ETS 300 036, which uses RPE/LTP
  11.      (regular pulse excitation/long term prediction) coding at 13 kbit/s.
  12.  
  13.  
  14. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  15.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////ddddmmmm____aaaauuuuddddiiiioooouuuuttttiiiillll....hhhh>>>>
  16.  
  17.      DDDDMMMMssssttttaaaattttuuuussss ddddmmmmGGGGSSSSMMMMEEEEnnnnccccooooddddeeee((((DDDDMMMMGGGGSSSSMMMMeeeennnnccccooooddddeeeerrrr hhhhaaaannnnddddlllleeee,,,,
  18.                        sssshhhhoooorrrrtttt ****iiiibbbbuuuuffff,,,, uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr ****oooobbbbuuuuffff,,,, iiiinnnntttt nnnnuuuummmmSSSSaaaammmmpppplllleeeessss))))
  19.  
  20.  
  21. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  22.      _h_a_n_d_l_e    DDDDMMMMGGGGSSSSMMMMeeeennnnccccooooddddeeeerrrr structure, created by ddddmmmmGGGGSSSSMMMMEEEEnnnnccccooooddddeeeerrrrCCCCrrrreeeeaaaatttteeee((((3333ddddmmmm)))),
  23.                specifies the signal processing parameters.
  24.  
  25.  
  26.      _i_b_u_f      pointer to input sample data buffer, an array of size of a
  27.                multiple of 160.  The data format is short (16-bit).  The
  28.                samples are assumed to be two's complement.   The sampling rate
  29.                must be 8 kHz.
  30.  
  31.  
  32.      _o_b_u_f      pointer to output data buffer, an array of a multiple of 33
  33.                bytes.  The data format is unsigned char (8-bit).
  34.  
  35.  
  36.      _n_u_m_S_a_m_p_l_e_s
  37.                number of sample in the input buffer to be processed.  the
  38.                value of numSamples passed to the GSM decode/decode routines
  39.                must always be a multiple of 160.  The compressed bitstrem
  40.                buffer consists of a multiple of 33 bytes.
  41.  
  42.  
  43. RRRREEEETTTTUUUURRRRNNNNEEEEDDDD VVVVAAAALLLLUUUUEEEE
  44.      Returns DDDDMMMM____FFFFAAAAIIIILLLLUUUURRRREEEE or DDDDMMMM____SSSSUUUUCCCCCCCCEEEESSSSSSSS.
  45.  
  46.  
  47. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  48.      ddddmmmmGGGGSSSSMMMMEEEEnnnnccccooooddddeeee((((3333ddddmmmm)))) implements GSM 06.10 compression.
  49.  
  50.  
  51.      GSM compression uses a linear prediction scheme.  This means that the
  52.      compressed bits, which carrying compressed information, are interrelated
  53.      or interdependent.  If a application calls aaaaffffSSSSeeeeeeeekkkkFFFFrrrraaaammmmeeee((((3333ddddmmmm)))) to an offset
  54.      into the compressed bit stream file and then starts reading bits in the
  55.      middle of the bit stream and decompress them with ddddmmmmGGGGSSSSMMMMDDDDeeeeccccooooddddeeee((((3333ddddmmmm)))), the
  56.      interdependency of the bits at the cutting point is lost.  The
  57.      application will initially get back data with a lower amplitude than if
  58.      he had read the same data back during a complete pass over the file from
  59.      the beginning.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ddddmmmmGGGGSSSSMMMMEEEEnnnnccccooooddddeeee((((3333ddddmmmm))))                                              ddddmmmmGGGGSSSSMMMMEEEEnnnnccccooooddddeeee((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74.      There is no way to exactly recreate the decoded data in the middle of the
  75.      bit stream file without going all the way back to the beginning.
  76.      However, with a "preroll" value to read ahead a portion of the compressed
  77.      file, application can compensate for the amplitude problem.
  78.  
  79.  
  80. NNNNOOOOTTTTEEEE
  81.      The compressed bitrate now is 13200 bits/s.  This is not the same as
  82.      standard specification of 13000 bits/s because the first 4 bits of each
  83.      33 byte are not useful information bits.  This bits arrangement was
  84.      adopted using the original scheme by Jutta Degener (jutta@cs.tu-
  85.      berlin.de) and Carsten Bormann (cabo@cs.tu-berlin.de), Communications and
  86.      Operating Systems Research Group, TU Berlin for compatibility with
  87.      typical UNIX applications.  And may be modify later.
  88.  
  89.      GSM algorithm was developed for sampling rate of 8 kHz.
  90.  
  91.  
  92. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  93.      dmGSMEncoderCreate(3dm), dmGSMEncoderDestroy(3dm), dmGSMDecode(3dm), ETSI
  94.      GSM 06.10 standard.
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.